home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / business / qfaxv107.zip / README.1ST < prev    next >
Text File  |  1996-09-15  |  16KB  |  288 lines
  1.         Before you use QuickStar FAX Pro V1.07 for the first time...
  2.  
  3.     QuickStar FAX Pro is a MS-DOS shareware program which allows you to
  4. send plain text faxes from the DOS command line of your PC computer, using
  5. a Class 1 or Class 2 fax/modem in your PC computer that's connected to a
  6. telephone line. QFAX can be used manually to send faxes. Or it can be called
  7. from a batch file or from your own program repeatedly to send out many faxes
  8. to multiple fax receivers. If you are too busy to read through the whole
  9. readme.1st file, please press PageDown now and go directly to the end of
  10. this file. There is a QUICK START UP GUIDE for QFAX at the end. QFAX is
  11. developed by a member of the Association of Shareware Professionals (ASP)
  12. and is distributed as a shareware program. For contact information of ASP,
  13. the official ASP OMBUDSMAN's statement and the concept of shareware please
  14. read the register.txt file.
  15.  
  16.     QFAX sends text fax VERY FAST! A regular 12 full pages text file can be
  17. transmitted within 4 minutes at 14400 bps modem speed! That is MUCH FASTER
  18. than what most other fax programs can do! Certainly fax speed depends on the
  19. capability of both fax devices. But QFAX achieves the best possible fax speed
  20. under the same fax conditions and helps you to reduce long distance telephone
  21. bill if you need to send fax from time to time!
  22.  
  23.     QFAX is very easy to use, too. To send a quick fax all you need to type
  24. in is something like this:
  25.  
  26.         qfax   myfile.txt  1-800-555-1212
  27.  
  28.     Or you can write your own computer program to invoke the above MS-DOS
  29. command to send multiple faxes out. By doing so you can send a batch of one
  30. hundred or even one thousand faxes easily using one command, and without the
  31. need of an operator to sit in front of the computer screen! A very simple C
  32. program called manyfax.c as well as the compiled executable is included to
  33. demonstrate how you can write your own fax application making use of QFAX.
  34.  
  35. BUT! Before you use QFAX for the first time you need to check the following:
  36.  
  37.    0. Can QFAX be used on your computer?
  38.       The system requirements of QFAX are: 8086 or above IBM-PC compatible
  39.       computers, including HP palmtop computers. (For HP palmtop There is a
  40.       separate version specifically written for HP palmtop. Available in
  41.       eddie.mit.edu:/pub/hp95lx/NEW/hpfax###.ZIP, with ### being the version
  42.       number.) You need a Class 1 or Class 2 fax compatible fax/modem to use
  43.       QFAX. QFAX is a MS-DOS program and can be run from either the DOS
  44.       prompt or from the DOS window launched from the Windows. It can also
  45.       be called by other programs as a command line fax sender.
  46.  
  47.    1. Check the completeness of the QFAX V 1.07 package you get.
  48.       It should include the following files:
  49.  
  50.         file_id.diz     A small file describing QFAX (required by BBS's)
  51.         vendinfo.diz    A description file used by shareware distributors
  52.         readme.1st      The file you are reading now
  53.         qfax.cfg        The QFAX configuration file
  54.         qfax.exe        The main fax sending program
  55.         qfaxrec.exe     The fax receiver, decoder and converter program
  56.         usage.txt       The file explaining detailed usages of QFAX
  57.         register.txt    A text file telling you how to register QFAX
  58.         register.frm    Registration form to be used for registration
  59.         qfaxconf.exe    Small program to help you to determine the modem
  60.                         port and create customized qfax.cfg file
  61.         manyfax.c       A simple C program that you can use to send out
  62.                         lots of faxes automatically, without attendance
  63.         manyfax.exe     The compiled program of manyfax.c
  64.         manyfax.fdb     A text format database file containing fax numbers
  65.         miscinfo.txt    Misc notes. About the Author. Where to find QFAX.
  66.  
  67.     2. The QFAX.CFG may need to be edited and configured to fit the specific
  68.        configuration of your computer. You can either edit QFAX.CFG file by
  69.        using DOS edit, or you can use qfaxconf.exe program to help create a
  70.        customized QFAX.CFG file. You may simply type "qfaxconf" at the DOS
  71.        command line to start. See the USAGE.TXT file for details.
  72.  
  73.     3. Read the REGISTER.TXT file for the license agreement and statement of
  74.        limited warranty. Simply using QFAX implies that you have read and
  75.        understand those conditions. And you agree to those conditions.
  76.  
  77.     4. Read the USAGE.TXT for information on how to use QFAX. The usage is
  78.        simple and straightforward but there are still something you want to
  79.        learn before you start for the first time.
  80.  
  81.     If you have done all of the above and have configured the QFAX.CFG file
  82. according to the instructions given in the USAGE.TXT file, you can go ahead
  83. to test QFAX and use it regularly.
  84.  
  85.     If you find QFAX useful to you, please register it with the author. The
  86. REGISTER.TXT tells you the benefit you will obtain from registration and
  87. method of how to register. The registration is simple and cheap!
  88.  
  89.     If you have any further questions regarding the usage of QFAX that you
  90. can not find the answer from the USAGE.TXT file, do not hesitate to ask the
  91. author. The REGISTER.TXT file has contact information on how to reach the
  92. author.
  93.  
  94.     QFAX is a shareware program and may be redistributed freely. But there
  95. are some conditions: You must distribute QFAX in its original and complete
  96. and zipped format and you are not allowed to change content of any file.
  97. You are not allowed to distribute QFAX for purpose of profit. No charge
  98. can be made on the distribution of QFAX except for a reasonable charge for
  99. the handling and material cost of the distribution. Under above conditions
  100. please feel free to distribute the QFAX software package.
  101.  
  102.     Finally, if you ever forget how to use QFAX, simply type "qfax" and it
  103. will give you a quick reminder screen!
  104. ---------------------------------------------------------------------------
  105.  
  106. Update History of QuickStar Fax Pro:
  107.  
  108. Sep. 1, 1995    First Release of QFAX.             Filename: qfaxv10.zip
  109.  
  110. Sep. 2 - Sep. 30  Some modifications to make QFAX work more reliable. Add
  111.                   an option to let user decide whether to pause or not
  112.                   before the beginning of fax transmission.
  113.  
  114. Oct. 1, 1995    Release of V1.01.                  Filename: qfaxv101.zip
  115. Oct.2 - Dec.9   More tests and improvements made to QFAX. Some bugs fixed.
  116. Dec. 10, 1995   Release of V1.02                   Filename: qfaxv102.zip
  117. Feb. 25, 1996   Release of V1.03                   Filename: qfaxv103.zip
  118. Apr. 8, 1996    Release of V1.04                   Filename: qfaxv104.zip
  119. Apr. 20, 1996   Release of V1.04B                  Filename: qfax104b.zip
  120. Jun. 16, 1996   Release of V1.05                   Filename: qfaxv105.zip
  121. Jul. 15, 1996   Release of V1.06                   Filename: qfaxv106.zip
  122. Aug. 15, 1996   Release of V1.06 for HP            Filename: hpfax106.zip
  123. Sep. 15, 1996   Release of V1.07                   Filename: qfaxv107.zip
  124.  
  125.     Improvements of V1.03 comparing with V1.02 include the following:
  126.  
  127.       a.Greatly reduced the amount of memory used by QFAX, making it more
  128.         suitable to be called by other programs so the user can construct
  129.         their batch fax sending system.
  130.       b.A fax receive and/or decode program is added to the package.
  131.       c.Some improvement of the fax subroutines.
  132.  
  133.     Improvements of V1.04 from V1.03 include the following:
  134.  
  135.       a.A memory allocation bug fixed.
  136.       b.Self-check subroutine added to make sure that the program is an
  137.         authentic file. If it is infected by a computer virus or modified
  138.         by a computer hacker, it will give warning.
  139.       c.Added some more configurable parameters, including the Wait For Modem
  140.         Connection Time. The qfaxconf.exe program is improved to include the
  141.         new parameters in configuration of qfax.cfg file.
  142.       d.QFAX104B.ZIP is the same as QFAXV104.ZIP except it stores 8x16 font
  143.         directly in the program. QFAX104B.ZIP can be used on HP100LX/HP200LX
  144.         palmtop computers.
  145.  
  146.     Improvements of V1.05 from V1.04 include the following:
  147.  
  148.       a.The memory usage of qfax.exe has been reduced by more than 100 KB.
  149.         So the program is more suitable to be called from other applications.
  150.       b.A few improvements made the Post Page Message more reliable.
  151.       c.The self-check subroutine in V1.04 has been removed to reduce the
  152.         size of the program.
  153.  
  154.     Improvements of V1.06 from V1.05 include the following:
  155.  
  156.       a.Improved the fax part greatly so it works more reliably on some USR
  157.         modems and others. Total fax connection time is displayed at the end.
  158.       b.Improvement of the command line interface so it can now be used to
  159.         fax pre-processed fax files and support wild card file names. Now
  160.         multiple files can be faxed together in one fax session.
  161.       c.QFAXREC.EXE has more functions. It can now be used to receive a fax
  162.         call, or convert fax files of ANY format into a PCX file, or into a
  163.         fax file that can be used by QFAX.EXE.
  164.       d.QFAXREC.EXE now takes much less memory to run.
  165.  
  166.     Improvements of V1.07 from V1.06 include:
  167.       a.Some discovered bugs are fixed. The fax procedure is more reliable now.
  168.       b.New features added to QFAX.EXE. Now you can configure pause time
  169.         before re-dial if the phone line is busy. You can specify whether
  170.         to remove the created *.fax file or not in the qfax.cfg file.
  171.       c.Improved QFAXREC.EXE so it's more reliable, and now fax receive works
  172.         with Class 2 fax/modem, too.
  173.       d.Modified QFAXCONF.EXE to adopt added features in qfax.cfg file.
  174.  
  175.     If the current version of QFAX you have is more than a few months old,
  176. the author may have already released a newer version of QFAX. Please contact
  177. the author at 102773.370@CompuServe.com, qfax@USA.COM or make phone call to
  178. 1-(814)-867-3385(H) for updates. 
  179. ---------------------------------------------------------------------------
  180.  
  181.                 Quick Start Up Guide
  182.  
  183.     To start using QFAX, you need to do two things:
  184.  
  185.       a.Configure the qfax.cfg file for your PC and fax/modem
  186.           ==> Configure the correct CommPort number
  187.           ==> Use the correct InitString for your modem
  188.           ==> Put your own phone number in the PhoneNumber line
  189.  
  190.       b.To send a plain text fax, the easiest way is use the command like:
  191.  
  192.           qfax  myfile.txt  1-800-555-1212
  193.  
  194.         There are other possible QFAX command line syntaxes. The formats all
  195.         look like this: (For a description of option flags check usage.txt)
  196.  
  197.           qfax  [-option flags]  file1 [file2] [file3...]  fax_number
  198.  
  199.         You can have zero, one, or many option flags right behind the QFAX
  200.         command and before the file names. You can specify one or many file
  201.         names followed by a fax number. If you forgot the fax number QFAX
  202.         will ask you for it after the program starts.
  203.  
  204.     QFAX.CFG is a plain text file and you can use any plain text editor to
  205. change it, like using the DOS edit command. Or you can run the qfaxconf.exe
  206. program to configure and modify qfax.cfg file. To run qfaxconf.exe, just
  207. type "qfaxconf" from the DOS prompt. This program is pretty self-explained.
  208.  
  209.     The format of QFAX.CFG file is pretty straight forward once you see the
  210. example qfax.cfg file. The detail of the format is described in USAGE.TXT.
  211.  
  212.     The 3 most important things you need to configure in QFAX.CFG is the
  213. CommPort number, InitString and PhoneNumber. You do not need to change any
  214. thing else if you just want to use the default setting.
  215.  
  216.     The CommPort number is the COM Port that the modem occupies. QFAX need
  217. number to access the modem correctly. Available numbers for CommPort are
  218. from 1 to 8. The base addresses and IRQ numbers are listed as below. Check
  219. your modem manual or consult a knowledgable person to find out what port
  220. your modems is set to.
  221.  
  222. CommPort COM/IRQ    Base_address  Description
  223.   1    COM1/IRQ4    3f8    --> commonly used by the mouse
  224.   2    COM2/IRQ3    2f8    --> most commonly used modem port
  225.   3    COM3/IRQ4    3e8
  226.   4    COM4/IRQ3    2e8    --> commonly used modem port
  227.   5    COM3/IRQ2    3e8    also called COM5
  228.   6    COM4/IRQ2    2e8    also called COM6
  229.   7    COM3/IRQ5    3e8    also called COM7 -> commonly used alternative port
  230.   8    COM4/IRQ5    2e8    also called COM8
  231.  
  232.  
  233.     The InitString is an AT command string that QFAX sends to the modem to
  234. initialize the modem for faxing. QFAX will not be able to send fax properly
  235. if the InitString is not set up properly, even if it says "Initialize OK".
  236.  
  237.     The correct InitString depends on the type of fax/modem you use.
  238. But most fax/modems use one of the following:
  239.  
  240.         AT&F&C1&D2
  241.         AT&F
  242.         AT&F&C1&D2&K3
  243.         AT&F&A3&B1&H1&R2&I2&C1&D2  <--- Recommended for USR modems
  244.  
  245.     For initial test of QFAX you may want to attach "M2L3" to the end of the
  246. InitString, like "AT&F&C1&D2M2L3". This AT command will keep the speaker of
  247. the modem connected all the time so you can hear how the fax process goes on.
  248. Once every thing works fine you can remove "M2L3" to make it quite.
  249.  
  250.     Some fax/modems, like U.S.Robotics, use different InitStrings. Check at
  251. the end of usage.txt file for a complete list of recommended InitString for
  252. various fax/modems. Or check your modem manual to find one. My experience is
  253. "AT&F&C1&D2&H1" will work fine for most USR modems, other than the above one.
  254.  
  255.     The PhoneNumber is a string that Identifies your fax when your fax/modem
  256. communicate with other fax machines. Normally it should be your phone number.
  257. The length of this string should not exceed 20 characters. You can use your
  258. name instead. But please do not leave this item blank.
  259.  
  260.     The rest of qfax.cfg is about font selection, page formatting etc. You
  261. can keep the default as it is for initial trials. For detailed information
  262. of those options please check the usage.txt file.
  263.  
  264.     You may put the name of the path that contains QFAX in the autoexec.bat
  265. file's PATH statement so next time you reboot the computer it will recognize
  266. QFAX from any directory. It is preferable that when you start QFAX, you go
  267. to the directory where your text file to be faxed is located. Even though
  268. usage like the following are allowed, too:
  269.  
  270.       QFAX  \mydir\myfile.txt 1-800-555-1212
  271.  
  272.     There are certain LIMITATIONS to the un-registered shareware version of
  273. QFAX. Those limitations includes: 1.Nag screen at start to ask you for a
  274. license number 2.You will be unable to adjust page size, line spacing and
  275. character spacing, after a certain trial period. though the faxing is still
  276. fully functional. All those limitations will be lifted once you register the
  277. shareware with the author. If you want to use QFAX for purpose of un-attended
  278. automatic batch fax sending, it is 100% sure you need to register to make it
  279. work, otherswise it will keep to ask you for a license number, which means
  280. you will have to sit there to enter a zero to get it going.
  281.  
  282.     To register QFAX, please read the file register.txt for how to register.
  283. Or you may simply fill out the register.frm text file, print it out, and then
  284. send it to me together with your registration fee.
  285. ----------------------------------------------------------------------------
  286. For helps, contact me at 102773.370@CompuServe.com, or call 1-814-867-1468(H)
  287. ----------------------------------------------------------------------------
  288.